home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmlogsummary.z / pmlogsummary
Text File  |  1997-04-03  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLOOOOGGGGSSSSUUUUMMMMMMMMAAAARRRRYYYY((((1111))))                                                PPPPMMMMLLLLOOOOGGGGSSSSUUUUMMMMMMMMAAAARRRRYYYY((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy - calculate averages of metrics stored in a PCP archive
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy [----aaaabbbbffffllllmmmmMMMMxxxxyyyyzzzz] [----nnnn _n_a_m_e_s_p_a_c_e] [----SSSS _t_i_m_e] [----TTTT _t_i_m_e] [----ZZZZ
  13.      _t_i_m_e_z_o_n_e] _a_r_c_h_i_v_e [_m_e_t_r_i_c_n_a_m_e ...]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy prints statistical information about metrics of numeric type
  17.      contained within the files of a Performance Co-Pilot (PCP) archive log.
  18.      The default output prints time averages for both counter and non-counter
  19.      metrics.  The archive log has the base name _a_r_c_h_i_v_e and must have been
  20.      previously created using ppppmmmmllllooooggggggggeeeerrrr(1).
  21.  
  22.      The metrics of interest are named in the _m_e_t_r_i_c_n_a_m_e arguments.  If
  23.      _m_e_t_r_i_c_n_a_m_e is a non-leaf node in the namespace (see ppppmmmmnnnnssss(4)), then
  24.      ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy will recursively descend the PMNS and report on all leaf
  25.      nodes.  If no _m_e_t_r_i_c_n_a_m_e argument is given, the root of the namespace is
  26.      used.
  27.  
  28.      Normally ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy operates on the default Performance Metrics
  29.      Namespace (PMNS), however if the ----nnnn option is specified an alternative
  30.      namespace is loaded from the file _n_a_m_e_s_p_a_c_e.
  31.  
  32.      The command line options ----SSSS and ----TTTT can be used to specify a time window
  33.      over which metrics should be summarized.  These options are common to
  34.      most Performance Co-Pilot tools and are fully described in
  35.      ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3).
  36.  
  37.      The remaining options control the specific information to be reported.
  38.      Metrics with counter semantics are converted to rates before being
  39.      evaluated.
  40.  
  41.      ----aaaa   Print all information.  This is equivalent to ----bbbbllllmmmmMMMMyyyy ....
  42.  
  43.      ----bbbb   Print both forms of averaging, that is both stochastic and time
  44.           averaging.
  45.  
  46.      ----ffff   Spreadsheet format - the tab character is used to delimit each field
  47.           printed.  This option is intended to allow ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy output to
  48.           import directly into common spreadsheet applications.
  49.  
  50.      ----llll   Also print the archive label, showing the log format version, the
  51.           time and date for the start and (current) end of the archive, and
  52.           the host from which the performance metrics values were collected.
  53.  
  54.      ----mmmm   Also print the minimum logged value for each metric.
  55.  
  56.      ----MMMM   Also print the maximum logged value for each metric.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMLLLLOOOOGGGGSSSSUUUUMMMMMMMMAAAARRRRYYYY((((1111))))                                                PPPPMMMMLLLLOOOOGGGGSSSSUUUUMMMMMMMMAAAARRRRYYYY((((1111))))
  71.  
  72.  
  73.  
  74.      ----xxxx   Print stochastic averages instead of the default (time averages).
  75.  
  76.      ----yyyy   Also print the number of samples encountered in the archive for each
  77.           metric.
  78.  
  79.      By default, ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy reports the time of day according to the local
  80.      timezone on the system where ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy is run.  The ----ZZZZ option changes
  81.      the timezone to _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as
  82.      described in eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the timezone to the local
  83.      timezone at the host that is the source of the performance metrics, as
  84.      specified in the label record of the archive log.
  85.  
  86. OOOOUUUUTTTTPPPPUUUUTTTT FFFFOOOORRRRMMMMAAAATTTT
  87.      For each metric, ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy produces a single output line as follows:
  88.  
  89.           _m_e_t_r_i_c_n_a_m_e  _v_a_l_u_e(_s) _u_n_i_t_s
  90.  
  91.      For metrics with possibly multiple instances, ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy produces
  92.      multiple lines of output as follows:
  93.  
  94.           _m_e_t_r_i_c_n_a_m_e ["_i_n_s_t_a_n_c_e _1"] _v_a_l_u_e(_s) _u_n_i_t_s
  95.           _m_e_t_r_i_c_n_a_m_e ["_i_n_s_t_a_n_c_e _2"] _v_a_l_u_e(_s) _u_n_i_t_s
  96.           _m_e_t_r_i_c_n_a_m_e ["_i_n_s_t_a_n_c_e _N"] _v_a_l_u_e(_s) _u_n_i_t_s
  97.  
  98.      The printed _v_a_l_u_e(_s) for each metric always follow this order:
  99.      stochastic average, time average, minimum, maximum and count.  The
  100.      individual values for each metric are space-separated (unless the ----ffff
  101.      option is used).
  102.  
  103.      All counter metrics which are measured in units of time will be converted
  104.      to seconds before being rate converted and used in the ppppmmmmllllooooggggssssuuuummmmmmmmaaaarrrryyyy
  105.      calculations.  The values calculated for these metrics are also printed
  106.      in seconds.
  107.  
  108.      The units will be displayed in the format described by ppppmmmmUUUUnnnniiiittttSSSSttttrrrr((((3333)))).
  109.  
  110. NNNNOOOOTTTTEEEESSSS
  111.      The average for an individual metric is calculated as follows:
  112.  
  113.      Non-counter metrics are averaged using stochastic averaging - each
  114.      observation has an equal weighting towards the calculation of the average
  115.      (the sum of all values divided by the total number of values, for each
  116.      metric).
  117.  
  118.      Counter metrics are averaged using time averaging (by default), but the
  119.      ----xxxx option can be used to specify that counters be averaged using the
  120.      stochastic method instead.  When calculating a time average, the sum of
  121.      the product of each sample value multiplied by the time difference
  122.      between each sample, is divided by the total time over which that metric
  123.      was logged.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMLLLLOOOOGGGGSSSSUUUUMMMMMMMMAAAARRRRYYYY((((1111))))                                                PPPPMMMMLLLLOOOOGGGGSSSSUUUUMMMMMMMMAAAARRRRYYYY((((1111))))
  137.  
  138.  
  139.  
  140.      Metrics whose measurements do not span 90% of the archive will be printed
  141.      with the metric name prefixed by an asterix (*).
  142.  
  143. FFFFIIIILLLLEEEESSSS
  144.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  145.      ////vvvvaaaarrrr////aaaaddddmmmm////ppppccccpppplllloooogggg////_h_o_s_t_n_a_m_e
  146.                              Default directory for PCP archives containing
  147.                              performance metric values collected from the host
  148.                              _h_o_s_t_n_a_m_e.
  149.  
  150. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  151.      ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmllllooooggggmmmmeeeerrrrggggeeee(1), ppppmmmmvvvvaaaallll(1), PPPPMMMMAAAAPPPPIIII(3),
  152.      ppppmmmmUUUUnnnniiiittttSSSSttttrrrr(3), and ppppmmmmnnnnssss(4)....
  153.  
  154. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  155.      All are generated on standard error and are intended to be self-
  156.      explanatory.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.